home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmScrollBar.z / XmScrollBar
Text File  |  1998-10-30  |  67KB  |  925 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr - The ScrollBar widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <Xm/ScrollBar.h>
  13.  
  14.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  15.           This page documents Motif 2.1.
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           The ScrollBar widget allows the user to view data that is
  19.           too large to be displayed all at once. ScrollBars are
  20.           usually located inside a ScrolledWindow and adjacent to the
  21.           widget that contains the data to be viewed. When the user
  22.           interacts with the ScrollBar, the data within the other
  23.           widget scrolls.
  24.  
  25.           A ScrollBar consists of two arrows placed at each end of a
  26.           rectangle. The rectangle is called the scroll region. A
  27.           smaller rectangle, called the slider, is placed within the
  28.           scroll region. The data is scrolled by clicking either
  29.           arrow, selecting on the scroll region, or dragging the
  30.           slider.  When an arrow is selected, the slider within the
  31.           scroll region is moved in the direction of the arrow by an
  32.           amount supplied by the application. If the mouse button is
  33.           held down, the slider continues to move at a constant rate.
  34.  
  35.           The ratio of the slider size to the scroll region size
  36.           typically corresponds to the relationship between the size
  37.           of the visible data and the total size of the data. For
  38.           example, if 10 percent of the data is visible, the slider
  39.           typically occupies 10 percent of the scroll region. This
  40.           provides the user with a visual clue to the size of the
  41.           invisible data.
  42.  
  43.           If the ScrollBar parent is an automatic ScrolledWindow, the
  44.           XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn default is True. Otherwise, the default is
  45.           False.
  46.  
  47.           ScrollBar holds the _X_m_Q_T_n_a_v_i_g_a_t_o_r traits.
  48.  
  49.         CCCCllllaaaasssssssseeeessss
  50.           ScrollBar inherits behavior, resources, and traits from the
  51.           CCCCoooorrrreeee and XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee classes.
  52.  
  53.           The class pointer is _x_m_S_c_r_o_l_l_B_a_r_W_i_d_g_e_t_C_l_a_s_s.
  54.  
  55.           The class name is XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr.
  56.  
  57.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  58.           The following table defines a set of widget resources used
  59.           by the programmer to specify data. The programmer can also
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           set the resource values for the inherited classes to set
  75.           attributes for this widget. To reference a resource by name
  76.           or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  77.           prefix and use the remaining letters. To specify one of the
  78.           defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
  79.           the XXXXmmmm prefix and use the remaining letters (in either
  80.           lowercase or uppercase, but include any underscores between
  81.           words).  The codes in the access column indicate if the
  82.           given resource can be set at creation time (C), set by using
  83.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  84.           not applicable (N/A).
  85.  
  86.                                           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  87.           NNNNaaaammmmeeee                       CCCCllllaaaassssssss                    TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt       AAAAcccccccceeeessssssss
  88.           XmNdecrementCallback       XmCCallback              XtCallbackList   NULL          C
  89.           XmNdragCallback            XmCCallback              XtCallbackList   NULL          C
  90.           XmNeditable                XmCEditable              Boolean          True          CSG
  91.           XmNincrement               XmCIncrement             int              1             CSG
  92.           XmNincrementCallback       XmCCallback              XtCallbackList   NULL          C
  93.           XmNinitialDelay            XmCInitialDelay          int              250 ms        CSG
  94.           XmNmaximum                 XmCMaximum               int              100           CSG
  95.           XmNminimum                 XmCMinimum               int              0             CSG
  96.           XmNorientation             XmCOrientation           unsigned char    XmVERTICAL    CSG
  97.           XmNpageDecrementCallback   XmCCallback              XtCallbackList   NULL          C
  98.           XmNpageIncrement           XmCPageIncrement         int              10            CSG
  99.           XmNpageIncrementCallback   XmCCallback              XtCallbackList   NULL          C
  100.           XmNprocessingDirection     XmCProcessingDirection   unsigned char    dynamic       CSG
  101.           XmNrepeatDelay             XmCRepeatDelay           int              50 ms         CSG
  102.           XmNshowArrows              XmCShowArrows            XtEnum           XmEACH_SIDE   CSG
  103.           XmNsliderSize              XmCSliderSize            int              dynamic       CSG
  104.           XmNsliderMark              XmCSliderMark            XtEnum           dynamic       CSG
  105.           XmNsliderVisual            XmCSliderVisual          XtEnum           XmSHADOWED    CSG
  106.           XmNslidingMode             XmCSlidingMode           XtEnum           XmSLIDER      CSG
  107.           XmNsnapBackMultiple        XmCSnapBackMultiple      unsigned short   MaxValue      CSG
  108.           XmNtoBottomCallback        XmCCallback              XtCallbackList   NULL          C
  109.           XmNtoTopCallback           XmCCallback              XtCallbackList   NULL          C
  110.           XmNtroughColor             XmCTroughColor           Pixel            dynamic       CSG
  111.           XmNvalue                   XmCValue                 int              dynamic       CSG
  112.           XmNvalueChangedCallback    XmCCallback              XtCallbackList   NULL          C
  113.  
  114.           XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk
  115.                     Specifies the list of callbacks that is called
  116.                     when the user takes an action that moves the
  117.                     ScrollBar by one increment and the value
  118.                     decreases.  The reason passed to the callback is
  119.                     XXXXmmmmCCCCRRRR____DDDDEEEECCCCRRRREEEEMMMMEEEENNNNTTTT.
  120.  
  121.           XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk
  122.                     Specifies the list of callbacks that is called on
  123.                     each incremental change of position when the
  124.                     slider is being dragged. The reason sent by the
  125.                     callback is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG.
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee
  141.                     Specifies how ScrollBar will react to user input.
  142.                     This resource can be True or False values, as
  143.                     follows:
  144.  
  145.                     TTTTrrrruuuueeee      Allows the scrollbar to be sensitive to
  146.                               user input. This is the default value.
  147.  
  148.                     FFFFaaaallllsssseeee     Makes the Scale scrollbar insensitive to
  149.                               user input. The visual is not greyed
  150.                               out. This value would mostly be used in
  151.                               XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRRmode.
  152.  
  153.                     When XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is used on a widget it sets the
  154.                     dropsite to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE.
  155.  
  156.           XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnntttt
  157.                     Specifies the amount by which the value increases
  158.                     or decreases when the user takes an action that
  159.                     moves the slider by one increment.  The actual
  160.                     change in value is the lesser of XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnntttt and
  161.                     (previous XXXXmmmmNNNNvvvvaaaalllluuuueeee - XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm) when the slider
  162.                     moves to the end of the ScrollBar with the minimum
  163.                     value, and the lesser of XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttand
  164.                     (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm- XXXXmmmmNNNNsssslllliiiiddddeeeerrrrSSSSiiiizzzzeeee - previous XXXXmmmmNNNNvvvvaaaalllluuuueeee)
  165.                     when the slider moves to the end of the ScrollBar
  166.                     with the maximum value.  The value of this
  167.                     resource must be greater than 0 (zero).
  168.  
  169.           XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk
  170.                     Specifies the list of callbacks that is called
  171.                     when the user takes an action that moves the
  172.                     ScrollBar by one increment and the value
  173.                     increases.  The reason passed to the callback is
  174.                     XXXXmmmmCCCCRRRR____IIIINNNNCCCCRRRREEEEMMMMEEEENNNNTTTT.
  175.  
  176.           XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy
  177.                     Specifies the amount of time in milliseconds to
  178.                     wait before starting continuous slider movement
  179.                     while a button is pressed in an arrow or the
  180.                     scroll region.  The value of this resource must be
  181.                     greater than 0 (zero).
  182.  
  183.           XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  184.                     Specifies the slider's maximum value.  XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  185.                     must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  186.  
  187.           XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm
  188.                     Specifies the slider's minimum value.  XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  189.                     must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  190.  
  191.           XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 10/24/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     Specifies whether the ScrollBar is displayed
  207.                     vertically or horizontally.  This resource can
  208.                     have values of XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL and XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL.
  209.  
  210.           XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk
  211.                     Specifies the list of callbacks that is called
  212.                     when the user takes an action that moves the
  213.                     ScrollBar by one page increment and the value
  214.                     decreases.  The reason passed to the callback is
  215.                     XXXXmmmmCCCCRRRR____PPPPAAAAGGGGEEEE____DDDDEEEECCCCRRRREEEEMMMMEEEENNNNTTTT.
  216.  
  217.           XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnntttt
  218.                     Specifies the amount by which the value increases
  219.                     or decreases when the user takes an action that
  220.                     moves the slider by one page increment.  The
  221.                     actual change in value is the lesser of
  222.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnntttt and (previous XXXXmmmmNNNNvvvvaaaalllluuuueeee -
  223.                     XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm) when the slider moves to the end of
  224.                     the ScrollBar with the minimum value, and the
  225.                     lesser of XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnntttt and (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm-
  226.                     XXXXmmmmNNNNsssslllliiiiddddeeeerrrrSSSSiiiizzzzeeee - previous XXXXmmmmNNNNvvvvaaaalllluuuueeee) when the slider
  227.                     moves to the end of the ScrollBar with the maximum
  228.                     value.  The value of this resource must be greater
  229.                     than 0 (zero).
  230.  
  231.           XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk
  232.                     Specifies the list of callbacks that is called
  233.                     when the user takes an action that moves the
  234.                     ScrollBar by one page increment and the value
  235.                     increases.  The reason passed to the callback is
  236.                     XXXXmmmmCCCCRRRR____PPPPAAAAGGGGEEEE____IIIINNNNCCCCRRRREEEEMMMMEEEENNNNTTTT.
  237.  
  238.           XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  239.                     Specifies whether the value for XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm should
  240.                     be on the right or left side of XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for
  241.                     horizontal ScrollBars or above or below XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm
  242.                     for vertical ScrollBars.  This resource can have
  243.                     values of XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP,,,, XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,,,,
  244.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, and XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT.  If the
  245.                     ScrollBar is oriented vertically, the default
  246.                     value is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM.  If the ScrollBar is
  247.                     oriented horizontally, the default value depends
  248.                     on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource of the widget.
  249.  
  250.           XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy
  251.                     Specifies the amount of time in milliseconds to
  252.                     wait between subsequent slider movements after the
  253.                     XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy has been processed.  The value of
  254.                     this resource must be greater than 0 (zero).
  255.  
  256.           XXXXmmmmNNNNsssshhhhoooowwwwAAAArrrrrrrroooowwwwssss
  257.                     Specifies whether the arrows are displayed and how
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 10/24/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     they are to be displayed. This resource can take
  273.                     the following values:
  274.  
  275.                     XXXXmmmmEEEEAAAACCCCHHHH____SSSSIIIIDDDDEEEE
  276.                               Indicates that one arrow is displayed on
  277.                               each end of the ScrollBar slider. This
  278.                               corresponds to a value of True in
  279.                               previous releases.
  280.  
  281.                     XXXXmmmmMMMMAAAAXXXX____SSSSIIIIDDDDEEEE
  282.                               Indicates that both arrows are displayed
  283.                               on the XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm side of the ScrollBar
  284.                               slider.
  285.  
  286.                     XXXXmmmmMMMMIIIINNNN____SSSSIIIIDDDDEEEE
  287.                               Indicates that both arrows are displayed
  288.                               on the XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm side of the ScrollBar
  289.                               slider.
  290.  
  291.                     XXXXmmmmNNNNOOOONNNNEEEE    Indicates that no arrows are displayed.
  292.                               This corresponds to a value of False in
  293.                               previous releases.
  294.  
  295.                     XXXXmmmmEEEEAAAACCCCHHHH____SSSSIIIIDDDDEEEE is the default value.
  296.  
  297.           XXXXmmmmNNNNsssslllliiiiddddeeeerrrrMMMMaaaarrrrkkkk
  298.                     Specifies the shape the slider is to be displayed
  299.                     in. This resource can take the following values:
  300.  
  301.                     XXXXmmmmEEEETTTTCCCCHHHHEEEEDDDD____LLLLIIIINNNNEEEE
  302.                               Specifies the slider as an etched line.
  303.  
  304.                     XXXXmmmmNNNNOOOONNNNEEEE    Specifies the slider as a foregrounded
  305.                               rectangle. This is the default for a
  306.                               regular slider.
  307.  
  308.                     XXXXmmmmRRRROOOOUUUUNNNNDDDD____MMMMAAAARRRRKKKK
  309.                               Specifies the slider as a shadowed
  310.                               circle. This is the default when the
  311.                               slider is a thermometer.
  312.  
  313.                     XXXXmmmmTTTTHHHHUUUUMMMMBBBB____MMMMAAAARRRRKKKK
  314.                               Specifies the slider as a series of
  315.                               three etched lines centered in the
  316.                               middle of the slider.
  317.  
  318.           XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee
  319.                     Specifies the mode the slider works in. There are
  320.                     two possible modes:
  321.  
  322.                     XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR  Allows the slider to move freely between
  323.                               the minimum and maximum ends of the
  324.  
  325.  
  326.  
  327.      Page 5                                         (printed 10/24/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                               scale. This is the default value.
  339.  
  340.                     XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR
  341.                               Forces the slider to be anchored to one
  342.                               side of the trough area.
  343.  
  344.           XXXXmmmmNNNNsssslllliiiiddddeeeerrrrSSSSiiiizzzzeeee
  345.                     Specifies the length of the slider between the
  346.                     values of 1 and (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm - XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm).  The
  347.                     value is constrained to be within these inclusive
  348.                     bounds.  The default value is (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm -
  349.                     XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm) divided by 10, with a minimum of 1.
  350.  
  351.           XXXXmmmmNNNNsssslllliiiiddddeeeerrrrVVVViiiissssuuuuaaaallll
  352.                     Specifies the color of the slider visual. This
  353.                     resource can take the following values:
  354.  
  355.                     XXXXmmmmBBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRR
  356.                               Specifies that the slider visual is in
  357.                               the background color.
  358.  
  359.                     XXXXmmmmFFFFOOOORRRREEEEGGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRR
  360.                               Specifies that the slider visual is in
  361.                               the foreground color.
  362.  
  363.                     XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWWEEEEDDDD____BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD
  364.                               Specifies that the slider visual is in
  365.                               the background color, with a shadow.
  366.                               This is the default for a regular
  367.                               slider.
  368.  
  369.                     XXXXmmmmTTTTRRRROOOOUUUUGGGGHHHH____CCCCOOOOLLLLOOOORRRR
  370.                               Specifies that the slider visual is in
  371.                               the trough color. This is the default
  372.                               when the slider is a thermometer.
  373.  
  374.           XXXXmmmmNNNNssssnnnnaaaappppBBBBaaaacccckkkkMMMMuuuullllttttiiiipppplllleeee
  375.                     Specifies the distance over which the scrollbar
  376.                     slider snaps back to its original position when
  377.                     the user drags the mouse outside the ScrollBar
  378.                     edge. This distance is defined in terms of
  379.                     multiples of the width of the slider. For example,
  380.                     a multiple of 0 (zero) causes the slider to snap
  381.                     back as soon as the pointer moves out of the
  382.                     ScrollBar frame, a multiple of 1 causes the slider
  383.                     to snap back as soon as the pointer moves beyond 1
  384.                     ScrollBar width of the ScrollBar edge.  Whenever
  385.                     the slider snaps back, the ScrollBar ddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk
  386.                     is called if there is one.
  387.  
  388.                     The default value is large enough to prevent
  389.                     unwanted snapBack activity if the mouse is moved
  390.  
  391.  
  392.  
  393.      Page 6                                         (printed 10/24/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     within the boundaries of any reasonable screen. To
  405.                     reset the default, set this resource to a large
  406.                     value, such as 10000.
  407.  
  408.           XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk
  409.                     Specifies the list of callbacks that is called
  410.                     when the user takes an action that moves the
  411.                     slider to the end of the ScrollBar with the
  412.                     maximum value.  The reason passed to the callback
  413.                     is XXXXmmmmCCCCRRRR____TTTTOOOO____BBBBOOOOTTTTTTTTOOOOMMMM.
  414.  
  415.           XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk
  416.                     Specifies the list of callbacks that is called
  417.                     when the user takes an action that moves the
  418.                     slider to the end of the ScrollBar with the
  419.                     minimum value.  The reason passed to the callback
  420.                     is XXXXmmmmCCCCRRRR____TTTTOOOO____TTTTOOOOPPPP.
  421.  
  422.           XXXXmmmmNNNNttttrrrroooouuuugggghhhhCCCCoooolllloooorrrr
  423.                     Specifies the color of the slider trough.  This
  424.                     color defaults to the color used for selections.
  425.  
  426.           XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the slider's position, between
  427.                     XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm and (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm - XXXXmmmmNNNNsssslllliiiiddddeeeerrrrSSSSiiiizzzzeeee).  The
  428.                     value is constrained to be within these inclusive
  429.                     bounds.  The initial value of this resource is the
  430.                     larger of 0 (zero) and XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  431.  
  432.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  433.                     Specifies the list of callbacks that is called
  434.                     when the slider is released after being dragged.
  435.                     These callbacks are also called in place of
  436.                     XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk, XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk,
  437.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk,
  438.                     XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk, XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk, or
  439.                     XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk when one of these callback
  440.                     lists would normally be called but the value of
  441.                     the corresponding resource is NULL.  The reason
  442.                     passed to the callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.
  443.  
  444.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  445.           ScrollBar inherits behavior and resources from the
  446.           superclasses described in the following tables.  For a
  447.           complete description of each resource, refer to the
  448.           reference page for that superclass.
  449.  
  450.                                                XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  451.           NNNNaaaammmmeeee                      CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  452.           XmNbottomShadowColor      XmCBottomShadowColor    Pixel              dynamic                CSG
  453.           XmNbottomShadowPixmap     XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                         (printed 10/24/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  467.  
  468.  
  469.  
  470.           XmNconvertCallback        XmCCallback             XtCallbackList     NULL                   C
  471.           XmNforeground             XmCForeground           Pixel              dynamic                CSG
  472.           XmNhelpCallback           XmCCallback             XtCallbackList     NULL                   C
  473.           XmNhighlightColor         XmCHighlightColor       Pixel              dynamic                CSG
  474.           XmNhighlightOnEnter       XmCHighlightOnEnter     Boolean            False                  CSG
  475.           XmNhighlightPixmap        XmCHighlightPixmap      Pixmap             dynamic                CSG
  476.           XmNhighlightThickness     XmCHighlightThickness   Dimension          dynamic                CSG
  477.           XmNlayoutDirection        XmCLayoutDirection      XmDirection        dynamic                CG
  478.           XmNnavigationType         XmCNavigationType       XmNavigationType   XmSTICKY_TAB_GROUP     CSG
  479.           XmNpopupHandlerCallback   XmCCallback             XtCallbackList     NULL                   C
  480.           XmNshadowThickness        XmCShadowThickness      Dimension          2                      CSG
  481.           XmNtopShadowColor         XmCTopShadowColor       Pixel              dynamic                CSG
  482.           XmNtopShadowPixmap        XmCTopShadowPixmap      Pixmap             dynamic                CSG
  483.           XmNtraversalOn            XmCTraversalOn          Boolean            dynamic                CSG
  484.           XmNunitType               XmCUnitType             unsigned char      dynamic                CSG
  485.           XmNuserData               XmCUserData             XtPointer          NULL                   CSG
  486.  
  487.                                                         CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  488.           NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  489.           XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  490.           XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  491.           XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  492.           XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  493.           XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  494.           XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  495.           XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  496.           XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  497.           XmNdepth                        XmCDepth                        int              dynamic                CG
  498.           XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  499.           XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  500.           XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  501.           XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  502.           XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  503.           XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  504.           XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  505.           XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  506.           XmNx                            XmCPosition                     Position         0                      CSG
  507.           XmNy                            XmCPosition                     Position         0                      CSG
  508.  
  509.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  510.           A pointer to the following structure is passed to each
  511.           callback:
  512.  
  513.           typedef struct
  514.           {
  515.                   int _r_e_a_s_o_n;
  516.                   XEvent * _e_v_e_n_t;
  517.                   int _v_a_l_u_e;
  518.                   int _p_i_x_e_l;
  519.           } XmScrollBarCallbackStruct;
  520.  
  521.           _r_e_a_s_o_n    Indicates why the callback was invoked.
  522.  
  523.  
  524.  
  525.      Page 8                                         (printed 10/24/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  533.  
  534.  
  535.  
  536.           _e_v_e_n_t     Points to the _X_E_v_e_n_t that triggered the callback.
  537.  
  538.           _v_a_l_u_e     Contains the new slider location value.
  539.  
  540.           _p_i_x_e_l     Is used only for XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk and
  541.                     XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk.  For horizontal ScrollBars,
  542.                     it contains the _x coordinate of where the mouse
  543.                     button selection occurred. For vertical
  544.                     ScrollBars, it contains the _y coordinate.
  545.  
  546.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  547.           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr includes translations from Primitive.  The
  548.           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr translations are described in the following
  549.           list.
  550.  
  551.           The following key names are listed in the X standard key
  552.           event translation table syntax.  This format is the one used
  553.           by Motif to specify the widget actions corresponding to a
  554.           given key.  A brief overview of the format is provided under
  555.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).  For a complete description of the
  556.           format, please refer to the X Toolkit Instrinsics
  557.           Documentation.
  558.  
  559.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  560.                     Select()
  561.  
  562.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  563.                     Release()
  564.  
  565.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa BBBBuuuuttttttttoooonnnn1111<<<<PPPPttttrrrrMMMMoooovvvveeeedddd>>>>:
  566.                     Moved()
  567.  
  568.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>:
  569.                     Select()
  570.  
  571.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn2222UUUUpppp>>>>:
  572.                     Release()
  573.  
  574.           ~~~~ssss ~~~~cccc ~~~~mmmm ~~~~aaaa BBBBuuuuttttttttoooonnnn2222<<<<PPPPttttrrrrMMMMoooovvvveeeedddd>>>>:
  575.                     Moved()
  576.  
  577.           ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>:
  578.                     TopOrBottom()
  579.  
  580.           ~~~~ssss cccc ~~~~mmmm ~~~~aaaa <<<<BBBBttttnnnn1111UUUUpppp>>>>:
  581.                     Release()
  582.  
  583.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffAAAAccccttttiiiivvvvaaaatttteeee>>>>:
  584.                     PrimitiveParentActivate()
  585.  
  586.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffCCCCaaaannnncccceeeellll>>>>:
  587.                     CancelDrag()
  588.  
  589.  
  590.  
  591.      Page 9                                         (printed 10/24/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  599.  
  600.  
  601.  
  602.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:
  603.                     TopOrBottom()
  604.  
  605.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:
  606.                     TopOrBottom()
  607.  
  608.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>:
  609.                     PageUpOrLeft(_L_e_f_t)
  610.  
  611.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
  612.                     PageUpOrLeft(_L_e_f_t)
  613.  
  614.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>:
  615.                     PageUpOrLeft(_U_p)
  616.  
  617.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>:
  618.                     PageDownOrRight(_R_i_g_h_t)
  619.  
  620.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
  621.                     PageDownOrRight(_R_i_g_h_t)
  622.  
  623.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>:
  624.                     PageDownOrRight(_D_o_w_n)
  625.  
  626.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>:
  627.                     PrimitiveHelp()
  628.  
  629.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  630.                     PageUpOrLeft(_U_p)
  631.  
  632.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>:
  633.                     IncrementUpOrLeft(_U_p)
  634.  
  635.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  636.                     PageDownOrRight(_D_o_w_n)
  637.  
  638.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>:
  639.                     IncrementDownOrRight(_D_o_w_n)
  640.  
  641.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  642.                     PageUpOrLeft(_L_e_f_t)
  643.  
  644.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>:
  645.                     IncrementUpOrLeft(_L_e_f_t)
  646.  
  647.           ::::cccc <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  648.                     PageDownOrRight(_R_i_g_h_t)
  649.  
  650.           ::::<<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:
  651.                     IncrementDownOrRight(_R_i_g_h_t)
  652.  
  653.           ~~~~ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn:
  654.  
  655.  
  656.  
  657.      Page 10                                        (printed 10/24/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  665.  
  666.  
  667.  
  668.                     PrimitiveParentActivate()
  669.  
  670.           ssss ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
  671.                     PrimitivePrevTabGroup()
  672.  
  673.           ~~~~mmmm ~~~~aaaa <<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb:
  674.                     PrimitiveNextTabGroup()
  675.  
  676.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  677.           The ScrollBar action routines are
  678.  
  679.           CancelDrag():
  680.                     If the key press occurs during scrolling, cancels
  681.                     the scroll and returns the slider to its previous
  682.                     location in the scrollbar, otherwise, and if the
  683.                     parent is a manager, it passes the event to the
  684.                     parent.
  685.  
  686.           IncrementDownOrRight(_D_o_w_n|_R_i_g_h_t):
  687.                     With an argument of DDDDoooowwwwnnnn, or 0 (zero) for
  688.                     compatibility, moves the slider down by one
  689.                     increment.  With an argument of RRRRiiiigggghhhhtttt, or 1 for
  690.                     compatibility, it moves the slider right by one
  691.                     increment.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  692.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward
  693.                     the right or bottom calls the callbacks for
  694.                     XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  695.                     is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward
  696.                     the right or bottom calls the callbacks for
  697.                     XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  The XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  698.                     is called if the XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk or
  699.                     XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk is NULL.
  700.  
  701.           IncrementUpOrLeft(_U_p|_L_e_f_t):
  702.                     With an argument of UUUUpppp, or 0 (zero) for
  703.                     compatibility, moves the slider up by one
  704.                     increment.  With an argument of LLLLeeeefffftttt, or 1 for
  705.                     compatibility, it moves the slider left by one
  706.                     increment.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  707.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement to the
  708.                     left or top calls the callbacks for
  709.                     XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  710.                     is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement to the
  711.                     left or top calls the callbacks for
  712.                     XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  The XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  713.                     is called if the XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk or
  714.                     XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk is NULL.
  715.  
  716.           Moved():  If the button press occurs within the slider, the
  717.                     subsequent motion events move the slider to the
  718.                     position of the pointer and call the callbacks for
  719.                     XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk.
  720.  
  721.  
  722.  
  723.      Page 11                                        (printed 10/24/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  731.  
  732.  
  733.  
  734.           PageDownOrRight(_D_o_w_n|_R_i_g_h_t):
  735.                     With an argument of DDDDoooowwwwnnnn, or 0 (zero) for
  736.                     compatibility, moves the slider down by one page
  737.                     increment.  With an argument of RRRRiiiigggghhhhtttt, or 1 for
  738.                     compatibility, moves the slider right by one page
  739.                     increment.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  740.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward
  741.                     the right or bottom calls the callbacks for
  742.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  If
  743.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  744.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  745.                     calls the XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkkcallbacks. The
  746.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is called if the
  747.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk or
  748.                     XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk is NULL.
  749.  
  750.           PageUpOrLeft(_U_p|_L_e_f_t):
  751.                     With an argument of UUUUpppp, or 0 (zero) for
  752.                     compatibility, moves the slider up by one page
  753.                     increment.  With an argument of LLLLeeeefffftttt, or 1 for
  754.                     compatibility, it moves the slider left by one
  755.                     page increment.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  756.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement to the
  757.                     left or top calls the callbacks for
  758.                     XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  If
  759.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  760.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement to the left or top calls
  761.                     the XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkkcallbacks. The
  762.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is called if the
  763.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk or
  764.                     XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk is NULL.
  765.  
  766.           PrimitiveHelp():
  767.                     Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  768.                     exist. If there are no help callbacks for this
  769.                     widget, this action calls the help callbacks for
  770.                     the nearest ancestor that has them.
  771.  
  772.           PrimitiveNextTabGroup():
  773.                     Traverses to the first item in the next tab group.
  774.                     If the current tab group is the last entry in the
  775.                     tab group list, it wraps to the beginning of the
  776.                     tab group list.
  777.  
  778.           PrimitiveParentActivate():
  779.                     If the parent is a manager, passes the event to
  780.                     the parent.
  781.  
  782.           PrimitivePrevTabGroup():
  783.                     Traverses to the first item in the previous tab
  784.                     group.  If the beginning of the tab group list is
  785.                     reached, it wraps to the end of the tab group
  786.  
  787.  
  788.  
  789.      Page 12                                        (printed 10/24/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  797.  
  798.  
  799.  
  800.                     list.
  801.  
  802.           Release():
  803.                     If the button press occurs within the slider and
  804.                     the slider position is changed, the callbacks for
  805.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk are called.
  806.  
  807.           Select(): IIIInnnn aaaarrrrrrrroooowwww:  Moves the slider by one increment in
  808.                     the direction of the arrow.  If
  809.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or
  810.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or
  811.                     bottom calls the callbacks for
  812.                     XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk, and movement to the left or
  813.                     top calls the callbacks for XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.
  814.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  815.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  816.                     calls the callbacks for XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk, and
  817.                     movement to the left or top calls the callbacks
  818.                     for XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  The
  819.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is called if the
  820.                     XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk or XXXXmmmmNNNNddddeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk is
  821.                     NULL.
  822.  
  823.                     IIIInnnn ssssccccrrrroooollllllll rrrreeeeggggiiiioooonnnn bbbbeeeettttwwwweeeeeeeennnn aaaannnn aaaarrrrrrrroooowwww aaaannnndddd tttthhhheeee sssslllliiiiddddeeeerrrr:
  824.                     Moves the slider by one page increment in the
  825.                     direction of the arrow.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  826.                     is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement
  827.                     toward the right or bottom calls the callbacks for
  828.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk, and movement to the left
  829.                     or top calls the callbacks for
  830.                     XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  If
  831.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  832.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  833.                     calls the callbacks for XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk,
  834.                     and movement to the left or top calls the
  835.                     callbacks for XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk.  The
  836.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is called if the
  837.                     XXXXmmmmNNNNppppaaaaggggeeeeIIIInnnnccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk or
  838.                     XXXXmmmmNNNNppppaaaaggggeeeeDDDDeeeeccccrrrreeeemmmmeeeennnnttttCCCCaaaallllllllbbbbaaaacccckkkk is NULL.
  839.  
  840.                     IIIInnnn sssslllliiiiddddeeeerrrr:  Activates the interactive dragging of
  841.                     the slider.
  842.  
  843.                     If the button is held down in either the arrows or
  844.                     the scroll region longer than the XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllDDDDeeeellllaaaayyyy
  845.                     resource, the slider is moved again by the same
  846.                     increment and the same callbacks are called.
  847.                     After the initial delay has been used, the time
  848.                     delay changes to the time defined by the resource
  849.                     XXXXmmmmNNNNrrrreeeeppppeeeeaaaattttDDDDeeeellllaaaayyyy.
  850.  
  851.           TopOrBottom():
  852.  
  853.  
  854.  
  855.      Page 13                                        (printed 10/24/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr((((3333XXXX))))
  863.  
  864.  
  865.  
  866.                     <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>> in an arrow or in the scroll
  867.                     region between an arrow and the slider moves the
  868.                     slider as far as possible in the direction of the
  869.                     arrow. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT
  870.                     or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or
  871.                     bottom calls the callbacks for
  872.                     XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk, and movement to the left or
  873.                     top calls the callbacks for XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk. If
  874.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  875.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  876.                     calls the callbacks for XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk, and
  877.                     movement to the left or top calls the callbacks
  878.                     for XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk.  The
  879.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is called if the
  880.                     XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk or XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk is NULL.
  881.                     Pressing <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>> or
  882.                     <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa>>>> moves the slider to the
  883.                     minimum value and invokes the XXXXmmmmNNNNttttooooTTTTooooppppCCCCaaaallllllllbbbbaaaacccckkkk.
  884.                     Pressing <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddDDDDaaaattttaaaa>>>>
  885.                     moves the slider to the maximum value and invokes
  886.                     the XXXXmmmmNNNNttttooooBBBBoooottttttttoooommmmCCCCaaaallllllllbbbbaaaacccckkkk.
  887.  
  888.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  889.           The bindings for virtual keys are vendor specific.  For
  890.           information about bindings for virtual buttons and keys, see
  891.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3).
  892.  
  893.      RRRREEEELLLLAAAATTTTEEEEDDDD
  894.           CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooollllllllBBBBaaaarrrr(3), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee(3),
  895.           XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrrGGGGeeeettttVVVVaaaalllluuuueeeessss(3), and XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrrSSSSeeeettttVVVVaaaalllluuuueeeessss(3).
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.      Page 14                                        (printed 10/24/98)
  922.  
  923.  
  924.  
  925.